home *** CD-ROM | disk | FTP | other *** search
/ Aminet 49 / Aminet 49 (2002)(GTI - Schatztruhe)[!][Jun 2002].iso / Aminet / dev / misc / FlexCat.readme < prev    next >
Text File  |  2002-03-23  |  9KB  |  193 lines
  1. Short:    2.5b - Flexible catalogs (C, Asm, Oberon, E, ARexx, Modula..)
  2. Author:   marcin@orlowski.com (Marcin Orlowski)
  3. Uploader: 303dmx@hetnet.nl (Michel 'DMX' Bagmeijer)
  4. Version:  2.5b
  5. Type:     dev/misc
  6. Replace:  dev/misc/FlexCat.lha
  7. Www:      http://amiga.com.pl/flexcat/
  8.  
  9.  
  10.   INFO
  11.   ----------
  12.  
  13.     FlexCat creates catalogs and the source to handle them. The difference
  14.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  15.   designed to produce any source you want:  any programming language, any
  16.   individual needs should be satisfied.  However, FlexCat is not more
  17.   difficult to use.
  18.  
  19.     Translators will also find it useful, as, among standard functions
  20.   like #?.catalog creation, FlexCat is able to update your #?.ct files
  21.   to the new #?.cd files automatically. Give it a try! 
  22.  
  23.     This sounds like a contradiction.  FlexCat's solution is to use
  24.   template files, the so called "source descriptions".  Ready to use examples
  25.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  26.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  27.   are welcome.
  28.  
  29.  
  30.   Archives
  31.   ----------
  32.  
  33.     Since release 2.0, the FlexCat distribution is splitted into the
  34.   smaller archives. They are (in order of importance):
  35.  
  36.   FlexCat.lha           - Latest FlexCat, user contribitions, english manual
  37.                          and foreign catalog files
  38.  
  39.   FlexCat_0x0.lha       - patches for 020, 040 and 060 versions of FlexCat
  40.                          (PPC makes no sense here. I checked that).
  41.  
  42.   FlexCat_ExDocs.lha    - FlexCat's guide in non english languages. Currently
  43.                          Svenska, Espanol and Deutsch are provided
  44.  
  45.   FlexCat_CatSrc.lha    - #?.cd and #?.ct files for existing translations and
  46.                          #?.texinfo documents
  47.  
  48.   FlexCat_Src.lha       - C source code for the FlexCat itself
  49.  
  50.   FlexCat_Demos.lha     - example source codes -> shows how to make localized
  51.                           programs using FlexCat (C/HSPascal/ARexx/etc)
  52.  
  53.                           NOTE: I would gladly welcome examples for other
  54.                           languages (E/Asm etc) as well as detailed tutorials 
  55.                           about right way of doing localized software.
  56.                           Your contribution is highly welcome!
  57.  
  58.  
  59.   If you just want to use FlexCat, the 1st archive is all you need.
  60.   If you want to have CPU optimised binaries, take both 1st and 2nd
  61.   and patch the original release.  If you want to read translated manual,
  62.   get the 3rd one.  If you want to make the translation take the 4th one
  63.   (but I suggesto to join the Amiga Translators' Organisation
  64.   <http://ato.vapor.com/ato> first!)
  65.  
  66.  
  67.   Changes since previous release:
  68.   -------------------------------
  69.   * v2.5b (19.03.02)- Added GG patchfile, thanks to Martin Blom <martin@blom.org>
  70.  
  71.  
  72.   * v2.5 (14.02.02) - Fixed the problem, if using $TODAY, that the date was
  73.                       one day ahead (tomorrow ;). Replaced gmtime() with
  74.                       localtime() (DMX).
  75.  
  76.  
  77.   * v2.4 (28.11.99) - FlexCat is now portable! Thanks to Hardcode.sd{tm}
  78.                       unique technology you can now try to compile FlexCat
  79.                       under any OS (both Big and Little Endians are
  80.                       supported). Read developer.readme for details.
  81.  
  82.                     - sometimes garbage could be written instead of
  83.                       $VER: string (when $TODAY feature was used) due
  84.                       to memory block being free'd before write.
  85.  
  86.                     - added ##rem command to .sd file handling. As you
  87.                       have probably guessed, it's just remark. The goal
  88.                       (at least for me) is that ##rem lines won't appear
  89.                       in result source code, creaded out of the .sd file.
  90.  
  91.                     - added manual catalog open/close for compilers that
  92.                       do not handle autoinit/exit functions
  93.  
  94.                     - Updated french translation (Herve Dupont
  95.                       <herve.dupont@nordnet.fr>)
  96.  
  97.                     - Added NOSPACE switch, to avoid extra space char
  98.                       usually used by FlexCat to separate comment
  99.                       mark ';' from the main comment text
  100.  
  101.                     - Source descriptor for HSPascal by Artur Karpunin
  102.                       <woody8@kki.net.pl> is now available.
  103.  
  104.                     - New archive "FlexCat_Demos" full ;-) of example
  105.                       source codes for various programming languages
  106.                       C, HSPascal and ARexx examples are recently
  107.                       available.
  108.  
  109.                     - Content of "Contribution" drawer is now moved to
  110.                       "FlexCat_Demos" archive.
  111.  
  112.                     - Added detailed tutoral (in polish for now) about
  113.                       the whole localization process (incl. examples)
  114.  
  115.  
  116.   * v2.3 (19.05.99) - "Trailing ellipsis" detector was broken (Marco
  117.                       De Vitis <marco.dvv@flashnet.it>)
  118.  
  119.                     - Seems I updated the english manual for v2.2, but
  120.                       forgot to create .guide file out of texinfo.
  121.  
  122.                     - Fixed manual to say "1999" instead of "1998", and
  123.                       fixed #?.cd file to show proper arguments when
  124.                       help ("?") is requested (Herve Dupont
  125.                       <herve.dupont@nordnet.fr>)
  126.  
  127.                     - Spanish translation by Sergio Martín Rodríguez
  128.                       <smartin@kaos.es> and Tomás J. Cantó
  129.                       <tjcanto@redestb.es>
  130.  
  131.  
  132.  
  133. Readme created with ARC 3.2 - Copyright (c)1996-99 by Jens Weyer.
  134.  
  135. ============================= Archive contents =============================
  136. Original  Packed Ratio    Date     Time    Name
  137. -------- ------- ----- --------- --------  -------------
  138.     2628    1138 56.6% 09-Jun-99 14:18:46 +FlexCat.catalog
  139.     3584    1564 56.3% 09-Jun-99 14:18:58 +FlexCat.catalog
  140.     3680    1668 54.6% 09-Jun-99 14:18:56 +FlexCat.catalog
  141.     3778    1669 55.8% 09-Jun-99 14:18:44 +FlexCat.catalog
  142.      637     303 52.4% 18-Aug-99 15:32:30 +ato.readme
  143.     2992    1372 54.1% 09-Jun-99 14:18:54 +FlexCat.catalog
  144.     3646    1688 53.7% 09-Jun-99 14:19:00 +FlexCat.catalog
  145.     3488    1514 56.5% 09-Jun-99 14:18:56 +FlexCat.catalog
  146.     3072    1419 53.8% 09-Jun-99 14:18:50 +FlexCat.catalog
  147.     3828    1839 51.9% 09-Jun-99 14:18:52 +FlexCat.catalog
  148.     4462    1839 58.7% 09-Jun-99 14:18:54 +FlexCat.catalog
  149.     2390    1164 51.2% 09-Jun-99 14:18:46 +FlexCat.catalog
  150.     3324    1543 53.5% 09-Jun-99 14:18:58 +FlexCat.catalog
  151.     3404    1565 54.0% 09-Jun-99 14:18:48 +FlexCat.catalog
  152.     3276    1514 53.7% 09-Jun-99 14:18:48 +FlexCat.catalog
  153.     3300    1492 54.7% 09-Jun-99 14:18:50 +FlexCat.catalog
  154.     3312    1599 51.7% 09-Jun-99 14:18:48 +FlexCat.catalog
  155.      632     277 56.1% 18-Aug-99 15:32:20  Docs.info
  156.      464     241 48.0% 25-May-97 15:47:24 +FlexCat_english.guide.info
  157.     2050     888 56.6% 28-Nov-99 04:36:40 +AmigaOberon.sd
  158.     1068     618 42.1% 28-Nov-99 04:36:40 +ARexx.sd
  159.     2809    1177 58.0% 28-Nov-99 04:36:40 +AutoC_c.sd
  160.      580     303 47.7% 28-Nov-99 04:36:40 +AutoC_h.sd
  161.     2969     914 69.2% 28-Nov-99 04:36:40 +AztecAs_asm.sd
  162.      503     238 52.6% 28-Nov-99 04:36:40 +AztecAs_i.sd
  163.     3339    1320 60.4% 28-Nov-99 04:36:40 +C++_CatalogF.cc
  164.     1525     732 52.0% 28-Nov-99 04:36:40 +C++_CatalogF.h
  165.      566     294 48.0% 28-Nov-99 04:36:40 +C++_cc.sd
  166.      798     429 46.2% 28-Nov-99 04:36:40 +C++_h.sd
  167.     5479    1967 64.0% 28-Nov-99 04:36:40 +C_c.sd
  168.     6471    1940 70.0% 28-Nov-99 04:36:40 +C_c_V20.sd
  169.     1825     751 58.8% 28-Nov-99 04:36:40 +C_c_V21.sd
  170.      790     413 47.7% 28-Nov-99 04:36:40 +C_h.sd
  171.     1570     845 46.1% 28-Nov-99 04:36:40 +Cat2h.readme
  172.     1857     794 57.2% 28-Nov-99 04:36:40 +Cat2h_c.sd
  173.      428     227 46.9% 28-Nov-99 04:36:40 +Cat2h_h.sd
  174.     2522     809 67.9% 28-Nov-99 04:36:40 +CatComp_h.sd
  175.     2090     708 66.1% 28-Nov-99 04:36:40 +E21b.sd
  176.     2560     835 67.3% 28-Nov-99 04:36:40 +E30b.sd
  177.     2183     833 61.8% 28-Nov-99 04:36:40 +E32e.sd
  178.      860     403 53.1% 28-Nov-99 04:40:04 +Hardcode_h.sd
  179.     3637    1313 63.8% 28-Nov-99 04:36:40 +HSPascalUnit.sd
  180.      552     329 40.3% 28-Nov-99 04:36:40 +Modula2Def.sd
  181.     2324     886 61.8% 28-Nov-99 04:36:40 +Modula2Mod.sd
  182.     2231     923 58.6% 28-Nov-99 04:36:40 +Oberon-A.sd
  183.     1818     798 56.1% 28-Nov-99 04:36:42 +Oberon_V38.sd
  184.     1817     797 56.1% 28-Nov-99 04:36:42 +Oberon_V39.sd
  185.     3033     927 69.4% 28-Nov-99 04:36:42 +SASasm_a.sd
  186.      486     231 52.4% 28-Nov-99 04:36:42 +SASasm_i.sd
  187.    36052   20499 43.1% 14-Feb-02 19:13:00  FlexCat
  188.    64113   20805 67.5% 14-Feb-02 20:10:18 +FlexCat_english.guide
  189.     5602    2379 57.5% 19-Mar-02 00:57:22  FlexCat.readme
  190.    20362    6725 66.9% 19-Mar-02 00:49:38  FlexCat.history
  191. -------- ------- ----- --------- --------
  192.   242766   99458 59.0% Operation successful.
  193.